================================================================================
  TINY TOON ADVENTURES: BUSTER'S HIDDEN TREASURE  --  PC Runtime v1.2 (23rd Sept 26)
================================================================================

  A custom PC port of the Sega Genesis / Mega Drive game. The console hardware
  (68000 CPU, VDP graphics, Z80 + FM/PSG sound) is reproduced in native code so
  the game runs directly on Windows -- no separate emulator needed -- with a few
  modern extras: a widescreen mode, video filters, save states, fullscreen, and
  an in-game menu (cheats, level select, sound test).

  This is a personal, non-commercial project. It does NOT include the game
  itself -- you must supply your own ROM of a cartridge you own.

  >>> IMPORTANT: this requires a good dump of the US (USA) ROM. <<<
  The runtime is built and tuned specifically for the US release -- the
  widescreen mode, level select, and other tweaks are matched to that exact
  version's internals. Other regions (European "E" / Japanese "J"), bad dumps,
  and hacked ROMs are NOT supported and are rejected on load (you'll be asked to
  pick a different file rather than the game freezing). The one you want is the
  verified good US dump, commonly named:

      Tiny Toon Adventures - Buster's Hidden Treasure (U) [!].bin

--------------------------------------------------------------------------------
  WHY DID I PORT THIS TO PC?
--------------------------------------------------------------------------------
  
  This is a bit of a personal passion project - it was the first game I purchased
  for my Sega Mega Drive back in 1993! Being a huge fan of Tiny Toon Adventures  
  I was very eager to play this game! It was actually quick difficult in later
  parts of the game!

  Maybe I will do some ports of other Tiny Toon games? Who knows - I was a big
  fan of the Super Nintendo Buster Busts Loose as well as the Gameboy games!

--------------------------------------------------------------------------------
  GETTING STARTED
--------------------------------------------------------------------------------

  Keep these together in the same folder:

     Buster's Hidden Treasure.exe   (the program -- you can rename it freely)
     SDL2.dll                       (required -- must sit next to the .exe)
     <your ROM file>                (the US "(U)" version -- .bin / .md / .gen)

  Then just double-click the .exe.

  FINDING THE ROM (automatic):
     On launch the program looks for your ROM in this order --
       1. A path it remembered last time (saved in "buster.ini").
       2. Any valid ROM file sitting in the same folder as the .exe.
       3. If it still can't find one, it opens a file picker so you can
          browse to it. The path you choose is remembered for next time.

  The easiest setup is simply to drop your ROM in the same folder as the .exe.


--------------------------------------------------------------------------------
  KEYBOARD CONTROLS  (in-game)
--------------------------------------------------------------------------------

     Move ................... Arrow Keys   (or W A S D)
     Jump ................... K   or  Spacebar
     Slide / Dash ........... J
     Special ................ H
     Start / Pause .......... Enter

     Open the menu .......... Esc          (see MENU below)


--------------------------------------------------------------------------------
  GAMEPAD CONTROLS  (Xbox-style layout; most USB / wireless pads work)
--------------------------------------------------------------------------------

     Move ................... D-Pad  or  Left Stick
     Jump ................... A
     Slide / Dash ........... X  (or B)
     Special ................ Y
     Start / Pause .......... Start
     Open the menu .......... Back / Select  (the "View" / Guide button)

  A controller plugged in while the game is already running is picked up
  automatically.


--------------------------------------------------------------------------------
  HOTKEYS  (work any time, during play)
--------------------------------------------------------------------------------

     F11 ...... Toggle fullscreen
     F10 ...... Toggle widescreen  (wider view; the HUD re-anchors to the edges)
     F9 ....... Cycle video filter: Sharp -> Smooth -> Scale2x -> Scanlines
     F5 ....... Save state         (into the current slot)
     F8 ....... Load state         (from the current slot)
     1-4 ...... Choose save slot 1, 2, 3, or 4


--------------------------------------------------------------------------------
  THE MENU
--------------------------------------------------------------------------------

  Press Esc (keyboard) or Back/Select (gamepad) to open the menu. The game
  pauses while it is open; music keeps playing.

  Navigating the menu:
     Up / Down ......... Move between items   (or W / S, or D-Pad)
     Left / Right ...... Change a setting     (slot, filter, widescreen)
     Enter / Space ..... Select               (or A / Start on a gamepad)
     Esc ............... Back out / close      (or B on a gamepad)

  Menu items:
     RESUME .............. Close the menu and keep playing.
     SAVE STATE .......... Save your exact spot into the current slot.
     LOAD STATE .......... Restore the current slot.
     SLOT ................ Pick which save slot (1-4) F5/F8 and the menu use.
     FILTER .............. Sharp / Smooth / Scale2x / Scanlines.
     COLOUR .............. Palette look: Vivid / Natural / Soft. "Vivid" is the
                           raw palette; the others gently reduce the saturation
                           for modern screens (the original was tuned for CRTs).
     WIDESCREEN .......... Turn the wider view on or off.
     FULLSCREEN .......... Toggle fullscreen.
     INTEGER SCALE ....... OFF / AUTO / 1X, 2X, 3X... Whole-number scaling
                           keeps every pixel exactly the same size, with black
                           bars filling any leftover space. AUTO picks the
                           biggest size that fits your window or screen; a
                           fixed size (e.g. 3X) is always used, and in a window
                           it also sizes the window to match.
     DISPLAY ............. Move the game to another monitor (works in
                           fullscreen too). The monitor is remembered.
     CHEATS .............. Infinite Lives, Infinite Health, Infinite Helpers,
                           Double Jump, Run Button, and "Give 98 Carrots".
                           (DOUBLE JUMP: press jump again in mid-air.  RUN
                           BUTTON: while it's ON, hold Left-Shift on the
                           keyboard, or RB on a gamepad, to move faster.)
     SOUND TEST .......... Play any music track or sound effect from the game.
     LEVEL SELECT ........ Jump straight to any level, 1 to 40 (see note below).
     RESET GAME .......... Restart from the title screen.
     CREDITS ............. Where to find me (YouTube, Reddit, GitHub, X).
     QUIT ................ Exit the program.


--------------------------------------------------------------------------------
  SAVE STATES
--------------------------------------------------------------------------------

  Save states capture your exact position at any moment (not just between
  levels). There are 4 slots.

     - Pick a slot with the 1-4 keys, or the SLOT item in the menu.
     - Save with F5, load with F8 (or use the menu items).

  Saves are stored in a "states" folder created next to the .exe.


--------------------------------------------------------------------------------
  NOTES
--------------------------------------------------------------------------------

  WIDESCREEN
     Widescreen shows more of the level on the left and right than the original
     4:3 view. The game was only ever drawn for 4:3, so at the very start and
     end of a stage the wider view would look past the edge of the level; the
     ground is extended there so you see terrain rather than walls or gaps.
     Two boss arenas (the level 5 and level 12 bosses) were never built wider
     than 4:3, so those two always play in 4:3 -- widescreen resumes as soon as
     you leave. Toggle widescreen any time with F10 or from the menu.

  SETTINGS ARE REMEMBERED
     Your display choices -- widescreen, fullscreen, video filter, colour mode,
     integer scale, monitor, and save slot -- are saved (in "buster.ini", next
     to the program) and restored on the next launch, so the game reopens
     exactly how you left it.

  LEVEL SELECT
     All 40 levels are selectable, including the final-stretch levels that the
     game normally only reaches by finishing the one before. Boss stages
     correctly hide the carrot / helper counters, just like the original.

  RENAMING THE .EXE
     You can rename the program to anything you like (e.g. "Buster's Hidden
     Treasure.exe"). It still finds SDL2.dll, your ROM, and your save states,
     because those are located next to the program, not by its name.


--------------------------------------------------------------------------------
  TROUBLESHOOTING
--------------------------------------------------------------------------------

  "SDL2.dll was not found"
     Make sure SDL2.dll is in the SAME folder as the .exe.

  "No ROM selected" / it can't find the game
     Put your ROM file in the same folder as the .exe, or pick it in the file
     browser that appears on launch.

  The window opens but the taskbar/Explorer icon looks wrong
     Windows caches program icons. Copying the .exe to a new name, or refreshing
     the icon cache, updates it. The icon shown while the game is running is
     always correct.

  No sound
     Make sure your system audio is working and not muted for the app. Sound
     continues even while the menu is open.

--------------------------------------------------------------------------------
  CREDITS
-------------------------------------------------------------------------------- 

  Find me over at https://www.youtube.com/adhgaming , on reddit as u/Darhkwing
  https://github.com/Darhkfox and on X at https://x.com/ADH_Gaming

--------------------------------------------------------------------------------
  LEGAL
--------------------------------------------------------------------------------

  Tiny Toon Adventures: Buster's Hidden Treasure, its characters, artwork, and
  the game data are copyright their respective owners (Konami / Warner Bros.).
  This runtime contains none of that content -- it requires a ROM dumped from a
  cartridge you legally own, and is intended for personal use only. Do not
  distribute the ROM or a copy of this program that includes game data or
  copyrighted artwork.

================================================================================
